Counts the number of font instances in a font.
OSStatus ATSUCountFontInstances (
ATSUFontID iFont,
ItemCount *oInstances);
iFont
A value of type ATSUFontID. Pass the ID of the font whose font instances you want to count.
oInstances
A pointer to a count. On return, the number of font instances defined in the font. You cannot pass NULL for this parameter.
function result
A result code. The result code kATSUInvalidFontErr indicates that the ID does not correspond to any installed font. For a list of other ATSUI-specific result codes, see Result Codes.
DISCUSSION
The ATSUCountFontInstances function determines the number of font instances that are defined in a font. You can pass one less than this count in the iFontInstanceIndex parameter of the function ATSUGetFontInstance.
